home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 401-425 / disk_402 / pcopy / pcopy.doc < prev    next >
Text File  |  1992-05-06  |  14KB  |  342 lines

  1.                               PCOPY
  2.  
  3.         Pcopy was made to produce large amounts of different copies in
  4.         busy environs.  Like:  People are talking to you and you are
  5.         searching programs for them in databases.  Others want
  6.         information how to install some driver.  You divert people to
  7.         others you know to be an authority on their problems.  You are
  8.         copying PD and you have an arrears of two hours.  People ask
  9.         whether their disks are ready yet.
  10.         What are you copying at the moment?  What have you already
  11.         done?  When to insert the next set?
  12.  
  13.         Pcopy shows the actual situation conveniently arranged, starts
  14.         upon disk insertion, and produces reliable copies, because it
  15.         can verify the written data.
  16.  
  17.         Pcopy does not copy copy-protected disks.  At least not that I
  18.         know.  Its working is similar to that of Trackdisk (The software
  19.         that normally controls the drives).  If Trackdisk cannot read a
  20.         disk, than Pcopy probably will not be able too.
  21.  
  22.         If your source disk is failing, you can let Pcopy try to produce
  23.         a copy with the original data recovered.
  24.  
  25.         Although Pcopy displays a lot of information, I think it is a
  26.         rather dangerous copier (on behalf of its autostart
  27.         capabilities) and its application lies in the production area.
  28.  
  29.  
  30.                               START
  31.  
  32.         Pcopy can be executed from either the CLI or the Workbench.
  33.         Two Trackdisk-drives must be available.  That is, ie., the
  34.         internal and a normal external drive.  Selection is done by
  35.         clicking on/off gadgets in a window.  When ready, one can
  36.         proceed by clicking "DONE". If more than two (or less than
  37.         two!) drives are selected, then clicking "DONE" has no effect.
  38.         It is also possible to give the drivenames on the commandline.
  39.         Pcopy will check for drive presence and type.  If the selected
  40.         drives are available, DOS is asked to stay away from them.
  41.         Pcopy takes control of the drives (as does diskcopy) and sets
  42.         up the user interface.  
  43.  
  44.  
  45.                              WINDOWS
  46.  
  47.         There are two small windows (marked "Now in DFx:") which show
  48.         at any moment the drive's contents.  An empty window means an
  49.         empty drive.  Normally the disknames appear in these windows.
  50.         If the disk cannot produce a name, a classification is
  51.         displayed.  All text different from <VolumeName> is printed in
  52.         another color. (black)
  53.  
  54.         In the window "Copy history" appear the names of all
  55.         successfully copied disks.  If you want a name to disappear,
  56.         double click on it.
  57.  
  58.         In the progression window the progress of the copy process is
  59.         graphical presented.  Although the depth gadgets are invisible
  60.         during the copy, they still exist and work.  The graph shows
  61.         first where pcopy HAS written.  Another color displays verify.
  62.         If the same track is to be written more than once, the color
  63.         will change again.  The number tells on which cylinder Pcopy
  64.         has written last.
  65.  
  66.         Further there is the control panel with the gadgets in it.
  67.  
  68.  
  69.                              GADGETS
  70.  
  71.  
  72.         -- Verify  ON/OFF
  73.  
  74.         The destination disk is read back and compared with the write
  75.         buffer.  It can be turned on and off during the copy process.
  76.  
  77.  
  78.         -- DFx: --> DFy:
  79.  
  80.         Defines which drive is source and which is destination.
  81.         Clicking the arrow reverses the direction.
  82.  
  83.  
  84.         -- Adapt Date
  85.  
  86.         DOS can distinguish the copy from the original if the creation
  87.         and last altered date and time are different on both disks.
  88.         If there are two disks present with the same volumename and
  89.         date/time, DOS will crash.  To prevent this, the standard
  90.         Diskcopy changes these fields.  Also if the BMFLAG is -1, it
  91.         changes it to +1. Pcopy can do this too, thus preventing to
  92.         create an exact copy.  Also if some read error could not be
  93.         repaired, Pcopy can set this flag to zero.  This all happens
  94.         with this gadget set to "ON".  Set to "OFF", the copy will be
  95.         exact (if possible).
  96.  
  97.  
  98.         -- Start Copy
  99.  
  100.         To be used to start the copy process manually.  The command is
  101.         hold until it is possible to start the copy process (two disks
  102.         inserted). A second click before the process is started will
  103.         nullify the start command.  This gadget changes into a
  104.         "Stop Copy" gadget during copying.  A confirmation is required.
  105.         Disk removal, source as well as destination, is handled as a
  106.         confirmed "Stop Copy".
  107.  
  108.  
  109.         -- Auto Start Condition
  110.  
  111.         This whole area is a gadget.  Click in it to cycle the four
  112.         stages.  See auto start for details.
  113.  
  114.  
  115.         -- Triangle gadget
  116.  
  117.         In the topborder there is a gadget with a triangle.  This
  118.         gadget affects the way Pcopy behaves to other disk users.  Its
  119.         usage of the drive hardware it so intensive, that normally
  120.         (triangle pointing up) other users do not get access to their
  121.         drives.  You can let Pcopy be a little more modest by letting
  122.         this gadget point down.  This costs from 3 to 70 seconds or
  123.         more copy time.
  124.  
  125.  
  126.                            AUTO START
  127.  
  128.         When a disk is inserted, it is classified.  To do so, the root
  129.         track is read and analyzed.  If an error is detected while
  130.         reading this track, Pcopy tries to repair the track to make
  131.         this classification safe.  Four different types are
  132.         distinguished and its classification appears in the "Now in .."
  133.         window:
  134.  
  135.  
  136.         -- New, Unformatted
  137.  
  138.         No data is detected.
  139.  
  140.  
  141.         -- Non DOS
  142.  
  143.         Some data is found.  But its format is not the normal Amiga
  144.         format.
  145.  
  146.  
  147.         -- DOS, no root
  148.  
  149.         The track can be read, but the root sector was not found.
  150.  
  151.  
  152.         -- <VolumeName>
  153.  
  154.         The root is found and the name of the disk is displayed.
  155.  
  156.  
  157.         Now that Pcopy knows what kind of disk its dealing with, it can
  158.         let the copy start depending on a user selected condition.
  159.         These are listed:  
  160.  
  161.  
  162.         -- Off: Manual Start
  163.  
  164.         Pcopy does not start copy until the Start gadget is clicked.
  165.  
  166.  
  167.         -- Dest must be New
  168.  
  169.         Pcopy starts only when a disk is classified as "New, Unformatted".
  170.         The formats that are known to be detected are MS-DOS, MSX,
  171.         Archimedes, Atari and Mac.  Probably most other formats are
  172.         detected too, but you must check it for yourself.
  173.  
  174.         -- Dest may not be DOS
  175.  
  176.         Pcopy starts only when a disk is classified as "New, Unformatted"
  177.         OR "Non DOS". By other systems already formatted disks are
  178.         overwritten.
  179.  
  180.         -- Unconditional Start
  181.  
  182.         Starts always upon insertion.  If the disk is not write
  183.         protected, it is simply overwritten.  This is a dangerous
  184.         selection and is emphasized by changing the gadget's color.
  185.         If an Amiga-DOS disk is to be overwritten, some sound is heard
  186.         and a three second delay will elapse before the copy process
  187.         starts.  When you remove the disk within this delay or click
  188.         the "Stop Copy" gadget, no writing has taken place.  You can
  189.         look at the Progression window, and if no graph or number is
  190.         visible, you were in time.  I can only say:  Do not use this
  191.         selection.
  192.  
  193.  
  194.                             REQUESTERS
  195.  
  196.         If an error is detected, a requester will appear.  If abort is
  197.         chosen, then the copy process will be terminated.  The actions
  198.         following upon retry are listed below:
  199.  
  200.            Source read error # xx
  201.            On cylinder # yy, head z.
  202.            <Short error description>
  203.  
  204.         Retry tries to read again.
  205.         Salve tries to repair the faulting track by multiple reads and
  206.         analysis.  Copy continues after this action.
  207.  
  208.            Destination write error # xx
  209.            On cylinder # yy, head z.
  210.            <Short error description>
  211.  
  212.         Retry tries to write again.
  213.  
  214.            Verify error # xx
  215.            On cylinder # yy, head z.
  216.  
  217.         Retry rewrites the track and checks again.
  218.  
  219.         If you do not know what the errors mean, ignore them.  Do a few
  220.         retries and abort if no success.
  221.  
  222.         Some actions produce confirmation requesters, like Stop Copy and
  223.         the standard stop gadget.  These are straightforward.  But
  224.         perhaps the system is too low on memory to honor the memory
  225.         requests to build the requester.  Then some defaults become
  226.         active:  "Abort" and "User was serious".
  227.  
  228.         The requester is not a true requester but a window with gadgets.
  229.         So if you use DMouse in a certain way, you have to place the
  230.         mouse pointer in this requester to use the standard keyboard
  231.         shortcuts.
  232.  
  233.  
  234.                            TRACK SALVAGE
  235.  
  236.         Pcopy has capabilities to recover data from a damaged track.  The
  237.         history window changes into a report window.  Each salved track
  238.         produces two lines.  The line starting with 'L' reports the not
  239.         recovered labels.  The 'S' reports not recovered sectors.  Behind
  240.         the 'S' and 'L' the tracknumber is displayed.  If the line
  241.         remains empty, you are lucky.  Otherwise the numbers of the not
  242.         recovered labels or sectors will appear.  Normally labels are not
  243.         used, and diskcopy does not copy them at all.  So ignore the
  244.         label report.  The not recovered sectors are more important.  A
  245.         disk that has been completely copied, but with one or more not
  246.         recovered sectors, appears Italic in the history window.  The
  247.         report remains visible as long as the destination disk stays in
  248.         the drive.  A special Pcopy pattern ('Pcopy2',X,0) is written
  249.         into not recovered sectors.  In that case if "Adapt Date" is ON,
  250.         the BMFLAG is made 0.
  251.  
  252.  
  253.                            PERFORMANCE
  254.  
  255.         Pcopy is fast (The fastest).  The best times: 100/68 seconds,
  256.         verify ON/OFF.
  257.  
  258.         Pcopy tries to be friendly to other tasks, it leaves them a lot
  259.         of time.  But in its disk use it is truly unfriendly.
  260.         Therefore you can force Pcopy to give way to other tasks which
  261.         want to use the disk hardware (other drives than those
  262.         controlled by (this) Pcopy, of course).
  263.  
  264.         It is recommended to install TrackSalve when Pcopy is used on a
  265.         system with more than two drives.  In the Trackdisk.device is a
  266.         nasty bug which can interfere with Pcopy.  Nevertheless pcopy
  267.         will deliver good copies.
  268.  
  269.  
  270.                             HISTORY
  271.  
  272.         Pcopy 2.0 is a rewrite of Pcopy 1.0.(Fish 151).  The copier
  273.         mostly in assembly and the user interface in C.  The user
  274.         interface became a separate task.  Pcopy uses ONLY code and data
  275.         derived from the original .i and .h files.  Therefore I think it
  276.         will be compatible with future releases of the OS.
  277.  
  278.         Pcopy 2.01.  The audio.device is not to be accessed in the
  279.         standard way, as I read recently in a publication of Commodore.
  280.         Pcopy used the standard method and sometimes the audio.device
  281.         died.  Pcopy waited for a reply.. forever...
  282.         The algorithms of the size of the requester and its gadgets used
  283.         the default font instead of the font of the screen on which
  284.         Pcopy executes.  The requesters now are perhaps a little nicer
  285.         when other fonts are used.
  286.         The salve routine has been made a little more efficient without
  287.         changing its functionality.  This results into a quicker login
  288.         of non-Dos disks and a slightly shorter track salvage.
  289.  
  290.     Pcopy 2.02.  The progression graph now reflects write, verify and
  291.     rewrite.
  292.  
  293.         Pcopy 2.1.  Better salve routines.  The routines in TrackSalve
  294.         are far superior to the old ones in Pcopy.  These routine are
  295.         now replaced.
  296.  
  297.         Pcopy 2.11. If just a sync was found, Pcopy classified the disk as
  298.         "Amiga format, no root" instead of "No Amiga format".
  299.  
  300.         Pcopy 2.12.  Stupid.  Both release versions 2.1 and 2.11 were by
  301.         a compile time flag actually debug versions with the salve
  302.         function partial disabled.  
  303.  
  304.  
  305.                             FUTURE
  306.  
  307.         The way the drives are snached away from the system while
  308.         remainingg disk-multitasking, prevents an easy adaption of
  309.         dynamic drive allocation.  That would be the most obvious
  310.         improvement of the program at the moment.
  311.         Multi-destination is out of the question, because it is not a
  312.         design aim.  Turbobackup has it implemented.  Besides that, the
  313.         autostart logic is already dreadful.  
  314.         Because Intuition is not that friendly in its cpu usage, it
  315.         should be better to have less windows open.  Therefore the graph
  316.         could be displayed in the control window and the other windows
  317.         could be made removable (recoverable).
  318.         A configfile.
  319.         Available drives investigation.
  320.         And single drive operation.
  321.         And multiple copy.
  322.         Etc. etc.
  323.         Guess who is silly.  First some money now with this machine.
  324.         
  325.  
  326.                             COPYRIGHT
  327.  
  328.         Copyright 1989, 1990 D.W.Reisig.  Pcopy is freely distributable
  329.         (FreeWare).  All you may charge for is medium costs.  You must
  330.         include this file (Pcopy.doc) with the program (Pcopy).  You are
  331.         not allowed to pass these files if changed.
  332.  
  333.  
  334.         If you have any suggestions or remarks:
  335.  
  336.         Dirk W. Reisig
  337.         Woudweeren 10
  338.         1151 AV  Broek in Waterland
  339.         The Netherlands (Holland)
  340.  
  341.         25-Oct-90
  342.